home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat2 / standard / readlink.z / readlink
Encoding:
Text File  |  1998-10-20  |  5.0 KB  |  133 lines

  1.  
  2.  
  3.  
  4. rrrreeeeaaaaddddlllliiiinnnnkkkk((((2222))))                                                        rrrreeeeaaaaddddlllliiiinnnnkkkk((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _rrrr_eeee_aaaa_dddd_llll_iiii_nnnn_kkkk - read the value of a symbolic link
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_uuuu_nnnn_iiii_ssss_tttt_dddd_...._hhhh_>>>>
  13.  
  14.      _iiii_nnnn_tttt _rrrr_eeee_aaaa_dddd_llll_iiii_nnnn_kkkk_((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_pppp_aaaa_tttt_hhhh_,,,, _cccc_hhhh_aaaa_rrrr _****_bbbb_uuuu_ffff_,,,, _ssss_iiii_zzzz_eeee______tttt _bbbb_uuuu_ffff_ssss_iiii_zzzz_))))_;;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      _rrrr_eeee_aaaa_dddd_llll_iiii_nnnn_kkkk places the contents of the symbolic link referred to by _p_a_t_h in
  18.      the buffer _b_u_f, which has size _b_u_f_s_i_z.  The contents of the link are not
  19.      null-terminated when returned.
  20.  
  21.      _rrrr_eeee_aaaa_dddd_llll_iiii_nnnn_kkkk fails and the buffer remains unchanged if:
  22.  
  23.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS              Search permission is denied for a component of the
  24.                          path prefix of _p_a_t_h.
  25.  
  26.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS              Read permission is denied on the file named by _p_a_t_h.
  27.  
  28.      _EEEE_FFFF_AAAA_UUUU_LLLL_TTTT              _p_a_t_h or _b_u_f extends outside the allocated address
  29.                          space of the process.
  30.  
  31.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL              The named file is not a symbolic link.
  32.  
  33.      _EEEE_IIII_OOOO                 An I/O error occurs while reading from or writing to
  34.                          the file system.
  35.  
  36.      _EEEE_LLLL_OOOO_OOOO_PPPP               Too many symbolic links are encountered in
  37.                          translating _p_a_t_h.
  38.  
  39.      _EEEE_NNNN_AAAA_MMMM_EEEE_TTTT_OOOO_OOOO_LLLL_OOOO_NNNN_GGGG        The length of the _p_a_t_h argument exceeds {_PPPP_AAAA_TTTT_HHHH______MMMM_AAAA_XXXX},
  40.                          or the length of a _p_a_t_h component exceeds {_NNNN_AAAA_MMMM_EEEE______MMMM_AAAA_XXXX}
  41.                          while ______PPPP_OOOO_SSSS_IIII_XXXX______NNNN_OOOO______TTTT_RRRR_UUUU_NNNN_CCCC is in effect.
  42.  
  43.      _EEEE_NNNN_OOOO_EEEE_NNNN_TTTT              The named file does not exist.
  44.  
  45.      _EEEE_NNNN_OOOO_SSSS_YYYY_SSSS              The file system does not support symbolic links.
  46.  
  47. NNNNOOOOTTTTEEEESSSS
  48.      _rrrr_eeee_aaaa_dddd_llll_iiii_nnnn_kkkk updates the time of last access (see _ssss_tttt_aaaa_tttt(2)) of the link.
  49.  
  50.      If the buffer passed to _rrrr_eeee_aaaa_dddd_llll_iiii_nnnn_kkkk is smaller than the symbolic link file
  51.      being read, _rrrr_eeee_aaaa_dddd_llll_iiii_nnnn_kkkk returns only as many characters as will fit in the
  52.      buffer.  Using a buffer of size _PPPP_AAAA_TTTT_HHHH______MMMM_AAAA_XXXX or greater eliminates the
  53.      possibility of reading an incomplete link value.
  54.  
  55. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  56.      Upon successful completion _rrrr_eeee_aaaa_dddd_llll_iiii_nnnn_kkkk returns the number of characters
  57.      placed in the buffer; otherwise, it returns -1 and places an error code
  58.      in _eeee_rrrr_rrrr_nnnn_oooo.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. rrrreeeeaaaaddddlllliiiinnnnkkkk((((2222))))                                                        rrrreeeeaaaaddddlllliiiinnnnkkkk((((2222))))
  71.  
  72.  
  73.  
  74. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  75.      _llll_ssss_tttt_aaaa_tttt(2), _ssss_tttt_aaaa_tttt(2), _ssss_yyyy_mmmm_llll_iiii_nnnn_kkkk(2), _rrrr_eeee_aaaa_llll_pppp_aaaa_tttt_hhhh(3).
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.